書式定義付きプレースホルダー
要素の出力テキストは、プレースホルダー(%
) を書式定義で挿入します。テキストが表示されると、プレースホルダーの代わりに変数の値が挿入されます。書式定義のデータ型と変数のデータ型は同一である必要があります。
表示される文字列は、 テキスト変数 財産。
要素プロパティ。変数は視覚化ユーザーは、要素内のテキストを指定できます。そのテキストは、たとえば、テキスト出力変数として保存され、表示されます。ユーザー入力は、入力形式に対応している必要があります。テキスト出力変数のデータ型は、入力形式に定義されているデータ型に対応している必要があります。
入力テキストのフォーマット定義は、 入力構成 ダイアログ、 テキスト入力、の 変数の書き込み 入力アクション。変数は テキスト変数 財産。
整数
整数のフォーマット定義の形式は次のとおりです。
% <フラグ> <最小桁数> <タイプ>
推奨されるデータタイプ: BYTE | WORD | DWORD | LWORD | SINT | USINT | INT | UINT | DINT | UDINT | LINT | ULINT
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<フラグ> | オプションと組み合わせ可能 | コード: テキスト変数 財産: | |
|
| 数字の最小幅(最小桁数で指定)を基準に左揃えで配置します。 | 文章 財産: |
|
| 常に符号付きで出力 | 文章 財産: 出力: |
|
| 最小桁数(符号を含む)に達するまで桁は0で埋められる。 | 文章 財産: |
<最小桁数> |
| オプション 最低人数 |
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<タイプ> | 必須 | ||
|
| 整数10進数として出力 | コード: 文章 財産: テキスト変数 財産: 出力: |
| コード: 文章 財産: テキスト変数 財産: 出力: | ||
|
| プレフィックスなしの符号なし整数2進数として出力します。 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| プレフィックスなしの符号なし8進整数として出力します。 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| プレフィックスとセパレータなしで、a~f(小文字)の数字を含む符号なし32ビット16進数として出力します。 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| プレフィックスとセパレータなしで、A~F(大文字)の数字を含む符号なし32ビット16進数として出力します。 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| プレフィックスとセパレータなしで、a~f(小文字)の数字を含む符号なし64ビット16進数として出力します。 注記: 推奨されるデータタイプ: | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| プレフィックスとセパレータなしで、A~F(大文字)の数字を含む符号なし64ビット16進数として出力します。 推奨されるデータタイプ: | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 符号なし整数10進数として出力 推奨されるデータタイプ: | コード: 文章 財産: テキスト変数 財産: 出力: |
固定小数点表記の浮動小数点数
浮動小数点数は、固定小数点表記の 10 進数として表示できます。この形式定義は次のようになります。
% <フラグ> <最小桁数> . <精度> f
この種のプレースホルダー変数に推奨されるデータ型: REAL | LREAL
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<フラグ> | オプションと組み合わせ可能 | ||
|
| 最小桁数を考慮して左揃えにする | |
|
| 常に符号付き、正の数の場合も含む | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 最小桁数(符号と小数点を含む)に達するまで、桁は0で埋められます。 | コード: 文章 財産: テキスト変数 財産: 出力: |
<最小桁数> 。 <精度> | オプション 指定しない場合は、標準形式1.6で数値が出力されます。 | ||
<最小桁数> |
| 符号と小数点を含む最小桁数 例: 12 | コード: 文章 財産: テキスト変数 財産: 出力: |
<精度> |
| 桁数と小数点の精度 例: 3 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 必須 小数点付き小数点表示のフォーマット識別子 | コード: 文章 財産: テキスト変数 財産: 出力: |
指数表記の浮動小数点数
浮動小数点数は、10 を底とする標準化された指数表記で表示できます。指数表記の形式定義は次の形式になります。
% <フラグ> <最小桁数> . <精度> <タイプ>
この種のプレースホルダー変数に推奨されるデータ型: REAL | LREAL
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<フラグ> | オプションと組み合わせ可能 | ||
|
| 最小桁数を考慮して左揃えにする | |
|
| 常に符号付き、正の数の場合も含む | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 最小桁数(符号と小数点を含む)に達するまで、桁は 0 で埋められます。 | コード: 文章 財産: テキスト変数 財産: 出力: |
<最小桁数> 。 <精度> | オプション 指定しない場合は、仮数は標準形式1.6で出力されます。 | ||
<最小桁数> |
| 符号(仮数部と指数部)、小数点、指数部を含む最小桁数( 例: 12 | コード: 文章 財産: テキスト変数 財産: 出力: |
<精度> |
| 仮数部と小数点の精度 例: 3 | コード: 文章 財産: テキスト変数 財産: 出力: |
<タイプ> | 必須 | ||
|
| 表示 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 表示 | コード: 文章 財産: テキスト変数 財産: 出力: |
整数の時間
互換性に関するお知らせ
通常の表示を得るために、V3.5 SP17以降では、秒の小数点以下の出力には原則として3桁の数字が使用されます(ms/µs/ns)。例: %t[dd-HH:mm:ss:ms]
、 ms
ミリ秒は 3 桁で指定します。この目的のため、2 桁のミリ秒数の前にゼロが付加されます。2 桁の出力が必要な場合 (V3.5 SP17 より前のバージョンのように)、アプリケーションのコンパイラ プロパティで特別なコンパイラ定義を設定する必要があります。 VISU_MILLISEC_NOLEADING_ZERO
。
出力テキストが %t
時間単位の識別子を付加すると、時間、時間期間、または時間間隔が出力されます。プレースホルダ変数は、 テキスト変数 財産。
時間単位ごとの時間のプレースホルダーの形式は次のとおりです。
%t[ <テキスト> <単位時間> <テキスト> ]
推奨されるデータタイプ: TIME
、 LTIME
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<単位時間> | 必須 時間単位の識別 時間値から指定された時間単位(日、時間、分、秒、ミリ秒)の完全な数値をフィルタリングします。 64ビットの時間値の場合、マイクロ秒とナノ秒も | ||
次の例に有効です: コード: テキスト変数 財産: | |||
|
| 先頭にゼロを付けない日数 | 文章 財産: 出力: |
|
| 先頭にゼロをつけた日数 | 文章 財産: 出力: |
|
| 時間数(0~23) | 文章 財産: 出力: |
|
| 時間数(00~23) | 文章 財産: 出力: |
|
| 時間数(0~23) | 文章 財産: 出力: |
|
| 時間数(00~23) | 文章 財産: 出力: |
|
| 分数(0~59)(先頭のゼロなし) | 文章 財産: 出力: |
|
| 分数(00~59)、先頭にゼロあり | 文章 財産: 出力: |
|
| 先頭のゼロを除いた秒数(00~59) | テキスト プロパティ: 出力: |
|
| 先頭にゼロが付いた秒数(00~59) | テキスト プロパティ: 出力: |
|
| ミリ秒単位の小数秒数(0~999) | テキスト プロパティ: 出力: |
|
| マイクロ秒単位の小数秒数(0~999) データ型のみ | テキスト プロパティ: 出力: 注: 定義の最大時間単位ではオーバーフローが許可されます。 |
|
| ナノ秒単位の小数秒数(0~999) データ型のみ | テキスト プロパティ: 出力: 注: 定義の最大時間単位ではオーバーフローが許可されます。 |
<テキスト> |
| オプション 括弧内に指定された文字列は出力に含まれます 注: 時間単位の識別子に対応する文字列、または時間単位の識別子を含む文字列を出力する場合は、文字列を一重引用符で囲む必要があります。 | テキスト プロパティ: 出力: テキスト プロパティ: 出力: |
括弧内では、時間単位の識別子を任意の回数だけ指定でき、任意の文字列と置き換えることができます。
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
| すべての時間単位の時間形式。間に通常の区切り文字が入ります。 | テキスト プロパティ: 出力: | |
| 時間単位の識別を考慮せずに、出力する必要がある追加の文字列を含むフォーマット この種の文字列は単純な直線引用符で囲まれます。 | テキスト プロパティ: 出力: |
10進数としての時間
推奨されるデータタイプ: TIME
、 LTIME
フォーマット定義では、時間の長さ <time in unit>
小数点の識別で識別できる <number of decimal places>
その結果、時間の長さは、指定された時間単位で小数点付き小数としてフォーマットされます。これは、次の時間形式で可能です。 HH | H | hh | h| mm | m | ss | s | ms |us | ns
これはユーザー入力に役立ちます。
期間を 10 進数で表すプレースホルダーの形式は次のとおりです。
%t[ <単位時間> <小数点以下の桁数>]
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<単位時間> | 必須 指定された時間単位(日、時間、分、秒、ミリ秒)の時間値を10進数としてフォーマットする時間単位の識別 64ビットの時間値の場合、マイクロ秒とナノ秒も | ||
<小数点以下の桁数> | 必須 小数点以下の最大桁数( 注: 入力や表示に小数点以下の桁数が必要ない場合でも、少なくとも数値は | ||
要件は次の例に適用されます。 コード: テキスト変数 財産: | |||
|
| 時間の値(時間単位)を小数で表す 時間数(0~23) 例: 4 | 文章 財産: ユーザー入力: 時間価値: |
|
| 時間値(分単位)を小数で表したもの 例: 2 | ユーザー入力: 時間価値 |
|
| 時間値(秒単位)を10進数で表す 例: 3 | ユーザー入力: 時間価値 |
| 例: 0 | ユーザー入力: 時間価値 | |
|
| 10進数で表した時間値(ミリ秒単位) 例: 3 | ユーザー入力: 時間価値 |
|
| 時間値(マイクロ秒単位)を10進数で表したもの 例: 3 | ユーザー入力: 時間価値 |
|
| 10進数で表した時間値(ナノ秒単位) 例: 0 | ユーザー入力: 時間価値 |
システム時刻
変数がフォーマット定義を持つプレースホルダーに割り当てられていない場合は、システム時刻が出力されます。
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
|
| 現在のシステム時刻の出力 要件: いいえ 変数は以下に指定されます テキスト変数 財産。 | 文章 財産: テキスト変数 プロパティ: 空白 出力: |
|
| オプション ローカルシステム時間のオフセットを世界時 (UTC) として出力します。 | 文章 財産: UTC変数に応じて
|
ヒント
システム時間のローカル タイム ゾーンを世界時刻 (UTC) にプログラムで切り替えることができます。
変数 VisuElems.Visu_DateTime.DisplayUTC
に設定されています TRUE
、システム時刻は世界時(UTC)で表示されます。デフォルトでは、変数 VisuElems.Visu_DateTime.DisplayUTC
に設定されています FALSE
システム時刻がローカルタイムゾーンで表示されるようになります。
日付と時刻の値を表示する場合は、タイムゾーンコードを使用してそれぞれの書式文字列を拡張できます。 Z
ローカルシステム時間での出力の場合、オフセットは世界時(UTC)で表示されます。たとえば、 dd:MM:yyyy HH:mm:ss:ms:Z
出力 01.08.2021 12:00:00:001:+02:00
. 世界時刻(UTC)を表示する場合は、UTC コードも表示されます。 01.08.2021 10:00:00:001:Z
日時
互換性に関するお知らせ
通常の表示を得るために、V3.5 SP17以降では、秒の小数点以下の出力には原則として3桁が使用されます(ms/µs/ns)。例: %t[dd-HH:mm:ss:ms]
、 ms
ミリ秒は3桁で指定します。2桁の先頭にゼロが付きます。 ms
2 桁の出力が必要な場合 (V3.5 SP17 以前のように)、アプリケーションのコンパイラ プロパティで特別なコンパイラ定義を設定する必要があります。 VISU_MILLISEC_NOLEADING_ZERO
。
日付と時刻の定義に推奨されるデータ型: DATE
、 DATE_AND_TIME
、 DT
、 LDATE
、 LDATE_AND_TIME
、 LDT
、 LTOD
、 TIME_OF_DAY
、 TOD
デフォルトでは、曜日と月の名前は英語で表示されます。ローカライズされたテキストを使用すると、 System
テキストリストを補足する必要があります。このテキストリストは自動的に作成されます。 POU(発注書) 表示すると %t
プレースホルダーが使用されます。ここでは、英語の用語を ID として使用する必要があります。ローカライズは、略称とフルネームの両方に対して行うことができます。
日付と時刻の定義のフォーマット文字列の形式は次のとおりです。
%t[ <日付と時刻の単位> ]
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<日付と時刻の単位> | 必須 日付と時刻の単位の識別 時間値(データ型:日付と時刻)から指定された単位(年、月、日、時間、分、ミリ秒)の値をフィルタリングします。 64ビットの日付と時刻の値の場合、マイクロ秒とナノ秒も | ||
|
| 世紀のある年 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 世紀なしの年 (00~99) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 世紀なしの年 (0~99) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 月のフルネーム | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 月の略称 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 月を数字で表す(01~12) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 月を数字で表す(1~12) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 曜日を数字で表す(1 = 月曜日 – 7 = 日曜日) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 曜日をフルネームで表記 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 曜日の略称 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 月の日付を数字で表す (01~31) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 月の日付を数字で表す(1~31) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 年内の通算日を数字で表したもの (001~366) | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 24時間形式の時間(00~23) 例
| コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 12時間形式の時間(01~12) 例
| コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 12時間形式の略語AまたはP Aは Pは 例
| コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 12時間形式のAMまたはPMの略語 AMの PMの 例
| コード: 文章 財産: テキスト変数 財産: 出力: |
括弧内では、日付と時刻の単位の識別子を任意の回数だけ指定でき、任意の文字列と置き換えることができます。
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
| 区切り文字で区切られた日付と曜日 | コード: 文章 財産: テキスト変数 財産: 出力: | |
| 時刻 | コード: 文章 財産: テキスト変数 財産: 出力: | |
| フォーマット定義に対応する文字列を出力する場合、文字列は一重引用符で表す必要があります。 | 文章 財産: 出力: |
文章
プレースホルダー変数の推奨データ型: STRING
、 WSTRING
文字列と文字列のフォーマット定義の形式は次のとおりです。
% <タイプ>
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
<タイプ> | |||
|
| ASCII文字セットの単一文字の出力 | コード: 文章 財産: テキスト変数 財産: 出力: |
|
| 文字列の出力 推奨されるデータタイプ: | コード: 文章 財産: テキスト変数 財産: 出力: UTF-8エンコードが有効になっている場合 詳細については、次を参照してください。 ダイアログ: プロジェクト設定: コンパイル オプション |
パーセント記号
パーセント記号の出力のフォーマット定義
構文 | 例 | 説明 | 視覚化の例 |
---|---|---|---|
|
| パーセント記号の出力 | プレースホルダー変数を使用する場合: コード: 文章 財産: テキスト変数 財産: 出力: |
文章 財産: 出力: |